home *** CD-ROM | disk | FTP | other *** search
/ Windows Expert / Windows Expert.iso / communic / twntlkdm.zip / TWINTALK.DOC < prev    next >
Text File  |  1990-05-23  |  17KB  |  524 lines
  1.  
  2. ╔═╦═╗  ╗   ╔  ╔═╦═╗  ╔╗  ╔  ╔═╦═╗  ╔═══╗  ╗      ╗  ╔═       ╔═══╗    ╔═══╗
  3. ╚ ║ ╝  ║ ║ ║    ║    ║║  ║  ╚ ║ ╝  ╠═══╣  ║      ╠══╩╗       ╔═══╝    ║   ║
  4.   ║    ║ ║ ║    ║    ║║  ║    ║    ║   ║  ║      ║   ║       ║     ╔╗ ║   ║
  5.   ╩    ╚═╩═╝  ╚═╩═╝  ╝╚══╝    ╩    ╝   ╚  ╩═══╝  ╝   ╚       ╚═══╝ ╚╝ ╚═══╝
  6.  
  7.                       Full MS Windows 3.0 support
  8.  
  9.               MS Windows Asynchronous Communications Software
  10.               for IBM (R) personal computers and compatibles
  11.  
  12.                       J.M. COHEN & O. PICCIOTTO
  13.  
  14.                     ENGLISH Version Distributed by:
  15.                         TWinTalk International
  16.                             P.O. Box 452
  17.                         New Hartford, CT 06057
  18.                         voice: 1-203-379-7727
  19.                  data : 1-203-738-0306 or 738-1046  8-N-1
  20.  
  21.                    NEW Features in TWinTalk version 2.0
  22.  
  23.       Please also see twintalk.pre for additional documentation
  24.  
  25.  
  26. 1) INTRODUCTION
  27.  
  28.  
  29. This documentation describes the new functions of the TWinTalk 2.0 product.
  30. Though this documentation is preliminary, the elements discussed here will
  31. also be part of the final documentation to be delivered with the product.
  32.  
  33. Besides the functional improvements, TWinTalk 2.0 is optimized over the
  34. previous version for speed and memory use.  The following functions will be
  35. described in the following chapters:
  36.  
  37.  
  38.                       New emulation support for VT220
  39.  
  40.                       New types of peripheral communication
  41.  
  42.                       Configuration of the menu by the user
  43.  
  44.                       Management of the DDE protocol
  45.  
  46.                       Usage of the scrollback buffer
  47.  
  48. 2)USAGE
  49.  
  50.  
  51.  
  52. 2.1) VT220 Emulation
  53.  
  54. TWinTalk now has VT220 emulation.  This emulation can be used for connections
  55. on DEC and UNIX machines.  VT220 supports all combinations of 8 bits, loading
  56. of key functions, management of protected fields and editing sequences.  This
  57. emulation is completely integrated in TWinTalk and is used in the same manner
  58. as all others.  Choose the TERMINAL menu option VT220 to invoke the emulation
  59. of this type of terminal.
  60.  
  61.  
  62.  
  63.  
  64. 2.2)New types of peripheral communication.
  65.  
  66.  
  67. TWinTalk 2. now has support for two more types of peripheral communication,
  68. COMBIOS (INT14) and NetBIOS.
  69.  
  70. Choose the following 'equipment selection' dialog box entries respectively for
  71. either of these peripherals.
  72.  
  73. COMBIOS.MOD for COMBIOS
  74. NETBIOS.MOD for Netbios
  75.  
  76. (This dialog box is obtained by first clicking on 'OPTIONS', then
  77. 'COMMUNICATIONS', then click on the appropriate '.mod' file.
  78.  
  79.  
  80. COMBIOS is generally used for communication on Local Area Networks or on X25
  81. data networks.  Certain types of Compilers or Communications products use
  82. the standard Interrupt 14 interface to give applications access to standard
  83. DOS communications services.
  84.  
  85. Take for example an X.25 PAD or a TCP/IP Telnet link. In both cases, usage of
  86. the COMBIOS facility enables TWinTalk to interface directly to the X.25 or
  87. TCP/IP 'layers' to connect itself to a remote machine. This significantly
  88. simplifies the interface so that TWinTalk need only pass minimal parameters
  89. indicating speed, size of the words, and number of stop bits. And, in most
  90. cases, the standard layers of communications under COMBIOS will not even
  91. need those.
  92.  
  93.  
  94. NETBIOS similarly allows TWinTalk to communicate with the layers of the
  95. NETBIOS protocol.  This configuration may currently be used in a UNIX
  96. environment that allows the connection of terminals through NETBIOS.  To
  97. implement this, TWinTalk must use the normal 'TELEPHONE NO.' field to find
  98. the name 'NETBIOS' on the machine to which the connection must be
  99. established.
  100.  
  101.  
  102.  
  103.  
  104. 2.3) Configuration of the Menus by the USER.
  105.  
  106. TWinTalk 2.0 expands on the previous concept of "Long Menu / Short Menu" to
  107. now allow the user much flexibility in creation of his own Menu configuration.
  108.  
  109.  
  110. The following functions may be changed:
  111.  
  112.            - The (in)visibility of the menu
  113.            - The "LABEL" of a menu item
  114.            - New user specific menu items may be added.
  115.  
  116. The first two are readily available through the "PROGRAM" menu selection, but
  117. the last can only be invoked via the TWinPas script language.
  118.  
  119. To change a Menu item, select the "PROGRAM" option, then the command "Change
  120. the menu". This will call up the Menu Configuration dialog box.  The box to the
  121. top left side lists all of the LABELS that correspond to all the main menu
  122. options of TWinTalk. To the right are the sub-menu items that are available
  123. under each of the main topics.
  124.  
  125.  
  126. The character '&' in a menu label indicates that the following letter should be
  127. highlighted. Some other special characters are supported.
  128.  
  129.  
  130. - "\t"   indicates that the characters that follow will be right-justified.
  131.  
  132. - "\a"   is only useful for the Main menu bar. It's function is to force
  133.          placement of the menu item at the furthest right position available
  134.          on the menu bar.
  135.  
  136.  
  137.  
  138. To modify a label, select it with your mouse or the keyboard, change the label
  139. field with your choice of name, and then 'click' on the 'CHANGE' box. Once all
  140. of the labels suit your taste, go to 'CONFIRM' to end the dialog.
  141.  
  142.  
  143. To 'Mask' a menu selection, click on the "VISIBILE" box. This will bring up the
  144. character '*'. Each menu label prefixed with this character will be masked.
  145.  
  146.  
  147. At any time, the base menu settings of TWinTalk may be restored by clicking
  148. 'Original". However, great care should be exercised during the changing of
  149. visibility of the "Change the Menus" field. Once the item is hidden, you will
  150. not be able to change the menus again nor return to the original menu. The
  151. only way out at this point is a complete restart of TWinTalk.
  152.  
  153.  
  154.  
  155. The commands 'Save a Menu" and 'Open a Menu' (selected from the PROGRAM menu)
  156. will allow you to respectively save the current menu settings or to load
  157. a new set. By default, all menu files have the extension '.MNU'. (for example,
  158. the file SHORT.MNU corresponds to a basic starting configuration for TWinTalk.)
  159.  
  160.  
  161.  
  162.  
  163. 2.4) Management of the DDE protocol.
  164.  
  165.  
  166. TWinTalk 2.0 has a complete implementation of the MS Windows DDE protocol, and
  167. can function like either a client or a DDE server.
  168.  
  169.  
  170.           - Client    In this mode, TWinTalk can communicate with another
  171.             application to ask for a specified item, to explicitly specify one
  172.             to the application, or to make it execute a specific command.
  173.  
  174.           - Server   In this mode, TWinTalk accepts all requests from other
  175.             clients and can transfer data items to other applications either
  176.             on command or spontaneously, while simultaneously executing
  177.             commands induced by other application softwares.
  178.  
  179.  
  180.  
  181. SERVER mode
  182. ----------
  183.  
  184.  
  185. The Server mode of TWinTalk is implicit... The program will always respond to
  186. DDE requests made by other applications. On the other hand, Client mode is
  187. explicit, and can only be invoked by special functions of the TWinPas
  188. script language of TWinTalk.
  189.  
  190. TWinTalk uses the following syntax to establish a dynamic link with an
  191. application:
  192.  
  193.             =Application|Topic!RxCy:RzCt
  194.  
  195.  
  196. Using EXCEL as an example, a link with TWinTalk will be written as follows:
  197.  
  198.  
  199.             =TWinTalk|Screen!R1C1L10
  200.  
  201. The syntax of the reference field is as follows:
  202.  
  203.             -Rx        The entire row of characters on the line 'x'.
  204.             -RxCyLx    The row 'x', from the 'y' character for length 'z'.
  205.             -Cy        The entire 'y' column.
  206.             -CyRxLZ    The entire column 'y' from row 'x' for a length 'z'.
  207.             -RxCy      The character on row 'x' in column 'y'.
  208.             -RxCy:RzCt The rectangular zone defined by the x,y,z,t screen
  209.                        coordinates.
  210.  
  211. Fortunately, there is a much simpler way to establish DDE links with TWinTalk
  212. without evr worrying about the syntax. In fact, a simple selection of the
  213. data items with the mouse followed by the command "COPY' (in the EDIT menu)
  214. will suffice to establish the links required for TWinTalk to put the data
  215. in the cell of the link reference. Of course, you must also call the command
  216. 'COPY with Link' in the client software (for example EXCEL) to establish its
  217. link reference for DDE exchange... Once the link is established at bothg ends,
  218. each modification on the TWinTalk screen will be automatically updated on the
  219. document managed by EXCEL.
  220.  
  221. Another functionality important on a DDE server is the ability to execute
  222. commands demanded by the other applications. For example, EXCEL can ask
  223. TWinTalk to to establish a connection to a remote host and transfer a file.
  224. To accomplish this, the DDE execution commands are used. For the application
  225. to send DDE commands to TWinTalk, one must first establish the DDE link from
  226. the client application with the Topic "SYSTEM" or "SCREEN" then use the send
  227. command function of the client application software. Refer to the documentation
  228. for your application for more details on how DDE functions are implemented
  229. within the specific application in use.
  230.  
  231. The TWinTalk supported commands are as follows:
  232.  
  233.  
  234. CONNECT              - Connect TWinTalk to the modem
  235.  
  236. DISCONNECT           - Disconnect TWinTalk from the modem
  237.  
  238. DIAL                 - Dial the current phone number
  239.  
  240. DIAL('12345678')     - Dial the specified number
  241.  
  242. CONFIG('file.ext')   - Change the default configuration file used to file.ext
  243.  
  244. TRANSFER('params')   - Start the file transfer.
  245.  
  246. EndXMit              - Stop the file transfer in process and delete any partial
  247.                        files if the transfer aborted.
  248.  
  249. RUN('file.ext')      - Execute the named script. If the extension is .CMP,
  250.                        execution is immediate. If .TWK, the script is first
  251.                        compiled and then executed.
  252.  
  253. EndRun               - Interrupt the currently executing script.
  254.  
  255.  
  256.  
  257.  
  258. CLIENT mode
  259. -----------
  260.  
  261. As explained above, TWinTalk can also act like a DDE Client. To accomplish
  262. this, special functions of the TWinPas language allow you to establish links
  263. with other applications, to exchange data items, and to make them execute
  264. commands.
  265.  
  266. These functions are:
  267.  
  268.  
  269.              - Talk('Application','Subject')
  270.              - Contact(Client ID)
  271.              - Request(Client ID,'parameters',review buffer)
  272.              - Poke(Client ID,'parameters',data items)
  273.              - Terminate(Client ID)
  274.  
  275. Example:
  276.  
  277.    -- This short program writes "TWINTALK" into an EXCEL cell.
  278.  
  279.    {$v-}       --  Execution Windows initially in 'invisible' mode
  280.  
  281.    {$l-}       --  No compiler listing generated.
  282.  
  283.    Program TESTDDE;
  284.  
  285.    Const
  286.         AppName = 'Excel';       -- Application to contact
  287.         Topic   = 'sheet1.xls;   -- Subject of the conversation
  288.  
  289.    Type
  290.         String = Array[1..90] Of Char;
  291.         Params = Array[0..20] Of Char;
  292.  
  293.    Var
  294.         hClient:Integer;         -- Client ID
  295.  
  296.    Begin
  297.         Show;
  298.  
  299.         hClient : = Talk(Appname, Topic);
  300.  
  301.         if Contact(hClient) Then
  302.         Begin
  303.             WriteLn(Appname, ' Contacted regarding ', Topic);
  304.             if Poke(hClient, 'r5c3', 'TWinTalk')  Then
  305.                 WriteLn('Items sent.');
  306.  
  307.             if Terminate(hClient) Then
  308.                 WriteLn('Link with ', AppName, 'Broken');
  309.         End
  310.         Else
  311.             WriteLn('No Contact with ', AppName);
  312.  
  313.    End.
  314.  
  315.  
  316.  
  317.  
  318.  
  319. 2.5) Use of the Review Buffer.
  320.  
  321.  
  322.  
  323. In addition to the capture function discussed in the TWinTalk documentation,
  324. TWinTalk also includes a review buffer function. This facility allows you to
  325. scroll backwards through lines of text that may already have scrolled off the
  326. visible screen during the on-line session. The size of the scrollback buffer is
  327. limited only by the available disk space. At any time you wish to call up the
  328. scrollback review buffer, the 'Scroll Lock' key is used. Once in Review mode,
  329. you can manipulate the the vertical elevator bar to move throughout the entire
  330. buffer. Once you have finished your review, depressing the 'Scroll Lock' key
  331. again will return you to the normal mode.
  332.  
  333.  
  334.  
  335. Review Buffer function keys:
  336.  
  337.  
  338.      -Scroll Lock    - Toggle buffer ON/OFF
  339.  
  340.      -Home           - Display the buffer, beginning at the top.
  341.  
  342.      -End            - Display the buffer, beginning at the bottom.
  343.  
  344.      -PgUp           - Move the display  up  10 lines.
  345.  
  346.      -PgDn           - Move the display down 10 lines.
  347.  
  348.      -Up Arrow       - Move the cursor  up  1 line.
  349.  
  350.      -Down Arrow     - Move the cursor down 1 line.
  351.  
  352.  
  353.  
  354.  
  355.  
  356. 3) New TWinPas language Commands.
  357.  
  358.  
  359. Procedures:
  360.  
  361.  
  362. Procedure Exit(code:Integer)
  363.  
  364.    Interrupts a program.
  365.  
  366.    If the parameter is '0' - execution stops and the current window remains
  367.                              on the screen (even if invisible).
  368.    If the parameter is '1' - execution stops and the window is closed.
  369.    If the parameter is '2' - execution stops,the window is closed,and TWinTalk
  370.                              is exited.
  371.  
  372.  
  373. Procedure Move(x,y,cx,cy:Integer);
  374.  
  375.    Moves the Window at coordinates 'x','y' (in pixels) and gives it a width of
  376.    'cx' and a height of 'cy'.
  377.  
  378. Procedure SetCom('1200,E,7,1':String);
  379.  
  380.    Allows a script to modify some of the current communications port parameters
  381.  
  382.  
  383.    Speed
  384.  
  385.         all values from 0 to 65,535 are acceptable to TWinTalk, but it should
  386.         be noted that the MS Windows communications driver (COMM.DRV) will not
  387.         currently be able to accept certain values.
  388.  
  389.    Parity
  390.  
  391.         n(None)
  392.         e(Even)
  393.         o(Odd)
  394.         m(Mark)
  395.         s(Space)
  396.  
  397.    Word size
  398.  
  399.         4,5,6,7 or 8 bits  (Anyone for Baudot?)
  400.  
  401.    Number of Stop bits
  402.  
  403.         1, 5 (for 1,5) or 2
  404.  
  405. Procedure ClipRect(x,y,cx,cy:Integer);
  406.  
  407.    Simulate the selection of a screen zone with the mouse. The paramters
  408.    are in character units of 1 to n.
  409.  
  410. Procedure ClipCopy;
  411.  
  412.    Copies the selection requested with the ClipRect into the Clipboard.
  413.  
  414. Procedure ClipPaste;
  415.  
  416.    Sends the contents of the Clipboard.
  417.  
  418. Procedure Caption('Title:String')
  419.  
  420.    Places the specified string of characters in the title band of the
  421.    executing Window.
  422.  
  423. Procedure Date(Date;Array of char);
  424.  
  425.    Obtains the system date in the format DD/MM/YY and loads it into a buffer.
  426.  
  427.  
  428. Procedure Time(Time;Array of char);
  429.  
  430.    Obtains the system time in the format HH:MM:SS and loads it into a buffer.
  431.  
  432. Procedure Zoom;
  433.  
  434.    Place TwinTalk in full Window mode.
  435.  
  436. Procedure Iconize;
  437.  
  438.    Place TwinTalk in Icon mode.
  439.  
  440. Procedure Restore;
  441.  
  442.    Place TwinTalk back to the mode it was in prior to a Zoom or Icon command.
  443.  
  444. Procedure LoadMenu('Filename.ext':String);
  445.  
  446.    Load a menu profile - if no path is given, the default path is used.
  447.  
  448. Procedure MenuVisible(Popup,Item:Integer,Visible:Boolean);
  449.  
  450.    Renders entire menus or selected items visible or invisible
  451.  
  452.       if Item = -1, the entire menu is affected.
  453.       if Item > -1, only the specified item of the popup menu is affected.
  454.  
  455. Procedure MenuAddItem(Popup,Item:Integer,'Label':String);
  456.  
  457.    Adds an item to a menu or adds a menu to the main menu bar.
  458.  
  459.       if Popup = -1, a full menu is added to the right on the menu bar
  460.       if Popup > -1, the specified item of the popup menu is added.
  461.  
  462.    Note: There are 7 possible main menu on the TWinTalk menu bar. The
  463.    menu on the far right (Help) is number 7.
  464.  
  465.  
  466. Procedure MenuRestore;
  467.  
  468.    Delete all items or menus added to the menu bar by the user, and terminate
  469.    the Window. This is only useful if you dynamically manage menus with script
  470.    files.
  471.  
  472. Procedure LineBreak(x:Integer);
  473.  
  474.    Generate a Break state on the communications line for x milliseconds.
  475.  
  476. Procedure PassWord(Psw:Array of char);
  477.  
  478.    Obtains the System password specified and store in the dialog box of the
  479.    current session. This procedure allows scripts to be totally independent
  480.    from the user.
  481.  
  482. Procedure Chain('filename.ext':String);
  483.  
  484.    End the execution of the current script and begin  executing the named
  485.    script. If no path is given, the default path is used. Please note, the
  486.    execution of the second script should be considered a 'goto' and not a
  487.    'call' - there is no return to the original script at the location following
  488.    the Chain....
  489.  
  490.  
  491. FUNCTIONS
  492. ----------
  493.  
  494. Function Inkey:Boolean;
  495.  
  496.    Returns the value 'true' if a character is available in the input buffer.
  497.    The character may be then read with 'Read'.
  498.  
  499. Function Alert('Title','Text'):Integer;
  500.  
  501.    Post a message box with the title and specified label. Returns a code
  502.    indicating which message box 'button' was pressed. (1=OK,2=CANCEL).
  503.  
  504. Function MenuInput:Integer;
  505.  
  506.    Returns the identifier of a menu item selected (0 to N).
  507.  
  508.  
  509. ----------end of twintalk.new           1/1/90      lww
  510.  
  511. -----------------------------------------------------------------------------
  512.  
  513.  
  514.  
  515.                                  COPYRIGHT NOTICE
  516.  
  517.  
  518.            TWinTalk Copyright (c) 1987, 1988, 1989 and 1990 by
  519.  
  520.                          J.M. COHEN & O. PICCIOTTO
  521.  
  522.       This document is Copyright (c) 1989,1990 by TWinTalk International
  523.  
  524.